home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 August / August CD.bin / Shareware / Utilities / Greg's Buttons Folder / Greg's Buttons Docs next >
Encoding:
Text File  |  1994-05-27  |  20.2 KB  |  389 lines  |  [ttro/ttxt]

  1. •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  2. Greg's Buttons 3.3 (29 May 1994)               ©1991-94 Gregory D. Landweber
  3. Internet: gdl@maths.ox.ac.uk                                       ALL RIGHTS RESERVED
  4. CompuServe: 73131,3326                     REGISTRATION FEE: US $15 or UK £10
  5. •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••
  6.  
  7. Greg's Buttons is a control panel that lets you customize the user interface
  8. of a Macintosh running System 7™.  Greg's Buttons requires that your Mac
  9. support color, so it won't work on the Plus, SE, Classic, or PowerBook 100.
  10. It works fine with both color and gray-scale monitors, and although it will
  11. still work on a black and white screen, the effect won't be as impressive.
  12.  
  13. LIST OF FEATURES
  14. =================
  15. •    Replaces the standard flat black and white push buttons, check boxes, and
  16.     radio buttons with tasteful 3-D color ones.  These buttons are designed to
  17.     complement the windows and scroll bars in the System 7 interface, and in
  18.     particular they use the color tints that you can select in the "Color"
  19.     control panel.  You can choose from two styles of push buttons and three
  20.     styles each of radio buttons and check boxes.  There is also an option to
  21.     draw the text of push buttons using an "embossed" style.
  22.  
  23. •    Substitutes a font of your choice (chosen from two versions each of
  24.     Palatino and Helvetica) for Chicago as your system font.  The system
  25.     font is used in menus, window titles, dialogs, and several other places
  26.     throughout the Mac interface.  Note that this feature does not just change
  27.     the menu font.  Also note that this feature has nothing to do with the
  28.     "Views" control panel, which changes the font in Finder™ windows.
  29.  
  30. •    Lets you select the background color of dialog boxes, menus (both the
  31.     text and background colors), and Finder™ windows. Since the dialog box
  32.     colorization feature is known to cause some unavoidable conflicts,
  33.     there is an "Exclude Applications…" button which lets you specify
  34.     applications in which the dialog boxes should not be colorized.
  35.  
  36. •  If you have Macintosh Easy Open or Hardware System Update 3.0, then
  37.     you may have noticed that the new small icons in the Open... and Save...
  38.     boxes are in color in some applications and black and white in others.
  39.     When the dialog box background color feature of Greg's Buttons is
  40.     turned on, these small icons will always be drawn in color (except in
  41.     the excluded applications). If you want color small icons but are not
  42.     partial to color dialog backgrounds, you can set the color to white.
  43.  
  44. •    Colorizes the mini icons in Finder™ list views (i.e., view by name, etc.).
  45.     (This feature is enabled only under Systems 7.0, 7.0.1 or 7.1.)
  46.  
  47. •    Colorizes the stop sign, caution, and note alert icons.
  48.  
  49. CHANGES SINCE v3.2
  50. ===================
  51. •  The button drawing routines are now "fat", containing both 680x0 and
  52.     PowerPC code for optimal performance on both Macs and Power Macs.
  53.     I introduced "fat" trap patches in version 3.2, and now Greg's Buttons is
  54.     as PowerPC-savvy as it is going to get. If you have a 680x0 Mac and
  55.     want to save 14K, I provide instructions for removing the PowerPC code.
  56.  
  57. •  Fixed the long standing bug with At Ease which disabled the Finder
  58.     window colorization feature and would cause the Finder to quit when
  59.     attempting to open the Greg's Buttons control panel.
  60.  
  61. •  Fixed an instability in the trap patches (introduced in version 3.2)
  62.     that tended to cause crashes at startup or shortly thereafter. The only
  63.     program that consistently triggered this problem was SndControl, but I
  64.     suspect that this will fix most of the other problems people reported.
  65.  
  66. •  Fixed another instability (also introduced in version 3.2) with one of the
  67.     trap patches. This problem manifested itself when you tried to run an
  68.     updater application made with UpdateMaker (such as the BBEdit updater),
  69.     in which case the application would do nothing and quit immediately.
  70.  
  71. •  Version 3.2 accidentally patched a PowerPC trap using only 680x0 code.
  72.     This particular patch is no longer installed on PowerMacs (since it did
  73.     not do anything on PowerMacs anyway). Special thanks go to the two
  74.     people who notified me when Conflict Catcher caught this anomaly.
  75.  
  76. •  Fixed a bug (introduced in version 3.2) with the exclusion list for the
  77.     dialog box colorization feature. The most notable consequence was that
  78.     SpaceWard Ho! would position some of its dialog boxes off the screen.
  79.  
  80. RESEDIT HACKING
  81. =================
  82. If you are using Greg's Buttons on a 680x0-based non-Power Mac, you can
  83. chop out the PowerPC code to save yourself 14k of disk space. All you need
  84. to do is open up a COPY of Greg's Buttons (I cannot stress this enough since
  85. the active Greg's Buttons file can become corrupted if opened with ResEdit)
  86. and remove the resource of type "PACH" and ID #129, which will be named
  87. "PowerPC Patches". This single resource contains all of the PowerPC code
  88. for both the trap patches and the button drawing routines.
  89.  
  90. The resulting lobotomized version will still run on a PowerMac; it will just
  91. use the existing 680x0 code under emulation.  I don't know why anybody
  92. would want to do this, but I expected someone would ask.
  93.  
  94. Please note that you should NOT under any circumstances remove the other
  95. "PACH" resource named "68k Patches". This resource is needed on BOTH Macs
  96. and Power Macs, and Greg's Buttons will not load at startup if it cannot find
  97. this resource.
  98.  
  99. KNOWN PROBLEMS
  100. =================
  101. Greg's Buttons does some serious fiddling with the Mac user interface.
  102. Applications often make invalid assumptions about their operating
  103. environment which no longer hold when you customize your Mac.  Since the
  104. programmers did not forsee these changes, and since they never had the
  105. opportunity to test their products with Greg's Buttons,  there are bound to
  106. be some conflicts.  In most cases, these are not the fault of Greg's Buttons,
  107. but if I find out about them, I will try my best to work around such
  108. problems.  Here are some of the most common examples:
  109.  
  110. PlainTalk
  111. ---------
  112. •  I am told that Greg's Buttons disables PlainTalk voice recognition in
  113.     some dialog boxes. I have no idea what is causing this problem. Sorry.
  114.     I'll try my best to fix it, but that's rather difficult without an AV Mac.
  115.  
  116. Keys!
  117. ------
  118. •    The "System 7 Color Buttons" feature conflicts with the control panel
  119.         "Keys!". When both are turned on, your buttons will revert to the standard
  120.         black and white ones. This conflict cannot be resolved, so if you want
  121.         both 3D buttons and keyboard control, try "Escapade" instead of "Keys!".
  122.  
  123. Ritz Software
  124. -------------
  125. •  The "System 7 Color Buttons" feature conflicts with the programs from
  126.     Ritz Software Ltd.  This is a due to a bug in their software, not mine,
  127.     and I have spoken with them, explaining how they can fix it.
  128.  
  129. MasterJuggler
  130. -------------
  131. •  The "Substitute System Font" feature will not function properly with
  132.     MasterJuggler version 1.57c or earlier, but it should work fine with
  133.     version 1.58.  Contact ALSoft for an upgrade.
  134.  
  135. Directory Assistance II
  136. ----------------------
  137. •  I am told that Directory Assistance II prevents Greg's Buttons from
  138.     colorizing the "New Folder..." button in the "Save as..." dialog box.
  139.     It seems that Directory Assistance II is overriding the normal button
  140.     drawing routines and is substituting its own custom black and white
  141.     version.  I am afraid that there is nothing I can do about this.  Sorry.
  142.  
  143. theTypeBook
  144. ------------
  145. •  When Greg's Buttons is installed, theTypeBook will generate a font
  146.     error message, reporting "System Heap bit set: Font not loaded" for
  147.     the ".Cambridge" FOND.  This is nothing to be concerned about, and
  148.     you can disable theTypeBook's font error checking using its "Other
  149.     Options" dialog box (obtained by holding down the option key and
  150.     selecting the "File" menu).
  151.  
  152. MacWrite II
  153. -----------
  154. •  When the "Substitute System Font" feature is enabled, the "File", "Edit",
  155.     "Size", "Style", and "Format" menus in MacWrite II may freeze closed and
  156.     refuse to pull down when you click on them.   To fix this problem, switch
  157.     to one of the "(Chicago Spacing)" versions of the substitute system font.
  158.     This is a bug in the menu drawing routines in MacWrite II.
  159.  
  160. •  If the "Font" menu in MacWrite II freezes closed, you should remove the
  161.     "Claris Fonts" file in your system folder (possibly in a subfolder named
  162.     "Claris") to force MacWrite II to reconstruct its 'Font" menu the next
  163.     time you launch it.  This is also a bug in MacWrite II.
  164.  
  165. Canvas
  166. -------
  167. •  When the "Substitute System Font" feature is enabled, some of the menu
  168.     items in Canvas may be "blurred" when you drag the mouse over them.  To
  169.     fix this problem, either turn off the "Substitute System Font" feature or
  170.     selct the "Helvetica 12 (Chicago Spacing)" font.  This is a bug in Canvas.
  171.  
  172. America Online
  173. --------------
  174. •  I have heard that the buttons in AOL remain flat.  This is not a bug in
  175.     Greg's Buttons.  Rather, AOL bypasses the usual button routines in favor
  176.     of its own custom routines that look like the old style buttons while
  177.     behaving slightly differently when pushed.  There is nothing I can do
  178.     about such applications that insist on using non-standard buttons.
  179.  
  180. Alarm Clock DA
  181. ---------------
  182. •  The Alarm Clock DA does not work properly with the "(Normal Spacing)"
  183.     substitute system fonts.  Use the "(Chicago Spacing)" fonts instead.
  184.     I think Apple has fixed this problem with the System 7.1 Alarm Clock.
  185.  
  186. WriteNow
  187. ----------
  188. •  If you try to use the Balloon Help for the Greg's Buttons control panel
  189.     while WriteNow 3.0 is running, you may encounter spurious help balloons
  190.     flashing on and off while you drag the mouse over Greg's Buttons.  This
  191.     happens with any control panel, and it appears to be a bug in WriteNow.
  192.  
  193. Microsoft Graph
  194. ---------------
  195. •  The Microsoft Graph module seems to override the System 7 Color Buttons
  196.     feature.   As far as I can tell, MSGraph bypasses the standard button
  197.     drawing (and window dragging) routines in favor of its own, which look
  198.     and behave just like the standard ones.  It also uses non-standard
  199.     windows without a close box, and it takes over a strip at the bottom of
  200.     the screen for a status bar.  Why can't Microsoft do things the Apple way
  201.     like everybody else?
  202.  
  203. COMMENTS and FAQs (Frequently Asked Questions)
  204. ==============================================
  205. If Greg's Buttons causes problems on your Mac, try disabling its features
  206. one-by-one until the problem goes away.  Most likely, the problem is caused
  207. by only one of the many features, and the rest of the features will work
  208. fine for you.  In particular, any problem relating to dialog boxes is probably
  209. caused by the dialog box colorization feature, while a problem involving
  210. menus is most likely due to either the substitute system font or the menu
  211. colorization feature.  The buttons themselves are exremely stable.
  212.  
  213. "Substitute System Font" Feature
  214. -------------------------------
  215. •  Several programs, such as Canvas, MacWrite II, and the Alarm Clock DA
  216.     do not bother to check the system font spacing, assuming the spacing for
  217.     Chicago.  As a result, they do not work properly with the "Normal Spacing"
  218.     versions of the substitute system fonts.  In order to maintain
  219.     compatibility with such programs, I have included a "Chicago Spacing"
  220.     version which uses spacing similar to Chicago.  You may notice, however,
  221.     that the numbers will appear oddly spaced in this version of the font.
  222.  
  223. •  No, it is not possible to substitute an arbitrary font for the system font.
  224.     The font has to be tweaked rather significantly in order for it to work
  225.     reliably.  If you have a pet font that you'd like to see added to the list of
  226.     alternate system fonts in Greg's Buttons, let me know via e-mail.
  227.  
  228. •  When you switch system fonts, the menus may not adjust to the new font
  229.     spacing immediately.  This will be fixed when the menu bar is redrawn.
  230.  
  231. •  Note that thin fonts, such as "Helvetica 12" and "Palatino 12" will be
  232.     illegible when dimmed or grayed-out on a black and white monitor.
  233.  
  234. •  The "Palatino 14" substitute system font is a little to big to work well
  235.     as a system font.  Push buttons may appear cramped, and text might not
  236.     always fit properly in dialog boxes.  On the other hand, I think this font
  237.     looks great on large screens, and I am willing to ignore such glitches.
  238.  
  239. "Alerts and Dialog Boxes" Background Color Feature
  240. -----------------------------------------------
  241. •  Some applications assume that they are dealing with a black and white
  242.     dialog box while Greg's Buttons substitutes a color one.  The difference is
  243.     enough to cause some odd behavior.  There is no way to fix such conflicts
  244.     without rewriting parts of the offending applications.  However, you can
  245.     specify applications to be excluded from this feature by clicking the 
  246.     "Exclude Applications..." button and adding the application to the exclusion
  247.     list.  The list includes Microsoft Word, Canvas, Help!, and Disk First Aid.
  248.  
  249. •  For some choices of the dialog box background color, the text insertion
  250.     cursor may be drawn in a just barely visible color.  This is the result of
  251.     the brain-dead routines the Mac uses to figure out a "suitable" inverse
  252.     (it thinks light yellow shows up well against a light gray, for instance).
  253.     To get around this, try changing the dialog box background color very
  254.     slightly, and the inverse routine may arbitrarily pick a better color.
  255.  
  256. •  When dialog colorization is turned on, you may notice that alert boxes
  257.     (the kind with the stop sign, caution, or note icon in the top-left corner)
  258.     are drawn with a grayed-out border.  This is a documented bug in the
  259.     system software, and Apple intends to fix it in a future release.
  260.  
  261. "Menu Bar and Menus" Color Feature
  262. --------------------------------
  263. •  If you have used another control panel (such as "Aurora" or "Kolor 2.0") to
  264.     color your menu bar, your previous menu color settings will override the
  265.     settings in the Greg's Buttons control panel.  If you want to use the menu
  266.     colorization feature in Greg's Buttons instead, use the other control panel
  267.     to set the menu colors back to black and white.  Greg's Buttons will then
  268.     remove the color information from the system file and substitute its own.
  269.  
  270. •  If your monitor is in 16-bit mode (thousands of colors) and you colorize
  271.     your menus, you may encounter gibberish in the menu bar when you launch
  272.     an application.  This is not a bug in Greg's Buttons (or Aurora or Kolor for
  273.     that matter), but rather a bug in the system software.
  274.  
  275. "Finder Window Color" Feature
  276. ----------------------------
  277. •  When you quit from an application that modifies the system color palette,
  278.     some Finder windows may be left with sploches of random colors in them.
  279.     This will go away as soon as the offending windows are re-drawn.  This
  280.     annoyance is inherent to the system and there is nothing I can do about it.
  281.  
  282. "System 7 Color Buttons" Feature
  283. -------------------------------
  284. •  The third radio button dot style uses the highlight color that you can
  285.     select in the "Color" control panel.
  286.  
  287. •  Occasionally, you may find that push button titles are "fuzzy", "blocky"
  288.     or "blurred".  This has been known to happen in Word, the HP DeskWriter
  289.     dialog box, and Alias Director.  This problem will go away if you turn
  290.     off the "Embossed Push Button Text".
  291.  
  292. "Finder Mini-Icon" Colorization Feature
  293. ------------------------------------
  294. •  If you are using System 7.0, 7.0.1 or 7.1, then Greg's Buttons will
  295.     automatically colorize the mini icons (the smallest size you can select
  296.     in the "Views" control panel) in Finder lists.  If you are using System 7
  297.     Pro or any version after System 7.1, then this feature will be disabled.
  298.     Nothing bad will happen; your mini-icons will just stay black and white.
  299.     I do not plan to re-implement this feature for future system versions.
  300.  
  301. •  Former versions of Greg's Buttons had a check box letting you turn this
  302.     feature on or off.  However, considering that the trap patch is relatively
  303.     innocuous and is already loaded into memory, I see no reason to disable it.
  304.  
  305. REGISTRATION
  306. ==============
  307. "Greg's Buttons" is SHAREWARE.  You may try it out for ten days. If after
  308. that time, you think it is a frivolous waste of processor time and disk
  309. space, just take a good look at your Mac without Greg's Buttons.  It will
  310. look dull, Dull, DULL!  If you want to keep it, you should register as follows:
  311.  
  312. Shareware Fees
  313. ---------------
  314. •  Single Machine License  —  US$15   / UK£10
  315. •  2 - 14 Machine License  —  US$10   / UK£6     per machine
  316. •  Unlimited Site License  —  US$150 / UK£100
  317.  
  318. Methods of Payment
  319. -------------------
  320. •  US Dollars, either by check (drawn on a US bank), postal money order, or
  321.     cash sent to my home address in the USA:
  322.         Gregory D. Landweber
  323.         10 Wallingford Drive
  324.         Princeton, NJ  08540
  325.  
  326. •  UK Pounds Sterling, either by cheque (drawn on a UK bank), EuroCheque,
  327.     or cash sent to my university address in England (until 31 August 1994):
  328.         G. D. Landweber
  329.         New College
  330.         Oxford  OX1 3BN
  331.  
  332. •  Please do not send EuroCheques in US$ as the USA is not a European
  333.     country and such cheques are not valid there.  If you want to send a
  334.     EuroCheque, make it out in UK£ and send it to my British address.
  335.  
  336. •  Please do not send any currencies other than US$ or UK£.
  337.  
  338. Please make the check payable to me, "Gregory D. Landweber", NOT to
  339. "Greg's Buttons".  With your payment please include your e-mail address
  340. (preferably internet), the version number, and where you got your copy.
  341.  
  342. You can also register online using CompuServe (in which case CompuServe
  343. gets 15% of the fee) by typing "GO SWREG" and following the instructions
  344. to register shareware.  The registration ID for Greg's Buttons is #1277.
  345.  
  346. After Registering
  347. -----------------
  348. •  There are no passwords, enabling codes, or registration numbers.  Once
  349.     you have registered, you are entitled to feel good about yourself and to
  350.     turn off the "Annoying Shareware Message" check box.  You will NOT get
  351.     any feedback from me to acknowledge receipt of your shareware payment.
  352.     Please do not worry whether I got your money.  If you sent a check, you'll
  353.     find out from your bank, and if you sent cash, well, it's the thought that
  354.     counts, isn't it!  Having paid once, you will never have to pay me anything
  355.     again, even if I add zillions of features and raise the shareware fee.
  356.  
  357. •  If you obtained this version from an online service, BBS, or User's Group,
  358.     then you should be able to obtain any and all new releases from the same
  359.     souce.  If you got this version from a CD-ROM or bundled with a book, and
  360.     if you have no other way of acquiring the latest update, send me a politely
  361.     worded letter explaining your predicament.  If the version you are using is
  362.     sufficiently out-of-date, I will eventually send you the most recent one.
  363.     Please do NOT mail me floppy disks or extra money and then complain that
  364.     I do not reply.  I'm a mathematician, not a commercial software publisher.
  365.  
  366. •  I will gladly e-mail a binhex'd copy of the latest version of Greg's Buttons
  367.     to anyone who e-mails me a request.  I can only send the file to addresses
  368.     on CompuServe, AOL, or the Internet.  The file is too large to cross the
  369.     gateway to AppleLink.  Sorry.
  370.  
  371. DISTRIBUTION
  372. ==============
  373. This software is NOT in the public domain; rather it is Copyright ©1994 by
  374. Gregory D. Landweber. You may freely copy and distribute this software,
  375. provided that it you do not charge for it.  This software MAY be included in
  376. any disk or CD-ROM library of public domain and shareware software sold by
  377. a NON-PROFIT organization.  This software MAY NOT be included in any
  378. commercial software collection sold for profit, nor may it be bundled with
  379. any commercial software, hardware, books, or other media without the
  380. prior written consent of the author.  Whenever it is distributed, the "Greg's
  381. Buttons" control panel must be accompanied by this documentation file IN FULL.
  382.  
  383. DISCLAIMER
  384. ============
  385. The author, Gregory D. Landweber, makes no warranties, either express or
  386. implied, regarding the fitness of the "Greg's Buttons" control panel for any
  387. particular purpose.  Use the "Greg's Buttons" control panel at your own risk.
  388. The author claims no liability for data loss or any other problems caused
  389. directly or indirectly by the "Greg's Buttons" control panel.